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Quick Start 





Novell. 


Novell GroupWise 8 is a cross-platform, corporate e-mail system that provides secure messaging, calendaring, scheduling, 
and instant messaging. GroupWise also includes task management, contact management, document management, and 
other productivity tools. Companion products provide secure instant messaging, synchronization with mobile devices, 
teaming, and telephone and soft phone conferencing for complete enterprise connectivity and collaboration. 


Your GroupWise system can run on NetWare, Linux, Windows, or any combination of these operating systems. GroupWise 
users can access their mailboxes from desktops running Linux, Windows, or Macintosh; in a Web browser anywhere an 
Internet connection is available; and on mobile devices. 


This Quick Start provides a high-level road map for novice GroupWise installers and a concise checklist of essentials for 
experienced GroupWise installers. For complete system requirements and installation instructions, see the GroupWise 
Installation Guide. 


Locating GroupWise Documentation 


GroupWise documentation is not included on the 
GroupWise 8 DVD or downloaded GroupWise 8 image. 
Instead, all GroupWise documentation is available on the 
GroupWise 8 Documentation Web site (http:// 
www.novell.com/documentation/gw8): 
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Known issues for all GroupWise components 


Installation overview for all GroupWise 
components 


Detailed system requirements and installation 
instructions for a basic GroupWise system and 
for all additional GroupWise components 


Creation and management of GroupWise 
domains, post offices, users, and all other 
GroupWise objects; configuration and 
optimization of all GroupWise agents; rollout 
strategies for the GroupWise client 


How to connect your GroupWise system to 
other GroupWise systems; how to merge 
GroupWise systems 


How to use GroupWise in the context of other 
products, including Novell products and third- 
party products 


Error messages, troubleshooting strategies, 
message flow diagrams, and directory 
structure diagrams 


Guide Contents 


Windows Client Complete instructions for using the GroupWise 


User Guide Windows client; also available in the client by 
clicking Help > User Guide; additional 
assistance available by clicking Help > Training 
& Tutorial 

Linux/Mac Complete instructions for using the GroupWise 

Client User Linux and Mac clients; also available in the 

Guide client by clicking Help > User Guide 

WebAccess Complete instructions for using the GroupWise 

Client User WebAccess client; also available in the client 

Guide by clicking Help > User Guide 


Installing a Basic GroupWise System 


A basic GroupWise system consists of a domain and a post 
office, a document library, and users. The Post Office Agent 
(POA) delivers messages between users’ mailboxes in 
each post office, and the Message Transfer Agent (MTA) 
routes messages between post offices and domains in a full 
GroupWise system. 


GROUPWISE SYSTEM REQUIREMENTS 
O x86-32 processor or x86-64 processor 


On a 64-bit processor, GroupWise still runs as a 32-bit 
application. 


O Any of the following server operating systems for the 
GroupWise agents: 


+ Novell Open Enterprise Server (OES) 2 (NetWare 
or Linux version), plus the latest Support Pack 


+ NetWare 6.5, plus the latest Support Pack 


¢ SUSE Linux Enterprise Server (SLES) 10 or 
SLES 11, plus the latest Support Pack 


+ Windows Server 2003, Windows 2003 R2, 
Windows Server 2008, or Windows Server 2008 
R2, plus the latest Service Pack 


O eDirectory 8.7 or later, plus the latest Support Pack, 
with LDAP enabled 


O ConsoleOne 1.3.6h or later 


GroupWise 8 includes ConsoleOne 1.3.6h for 
Windows and for Linux on the DVD or downloaded 
GroupWise 8 image. 


ConsoleOne requires Java Virtual Machine (JVM) 
1.5.11 or later. On Windows, ConsoleOne also 
requires the Novell Client. On Linux, ConsoleOne also 


requires the X Window System, version X11R6 or later. 


O Any of the following environments for running 
ConsoleOne and the GroupWise Installation program: 


+ Windows XP, Windows Vista, or Windows 7, plus 
the latest Service Pack for your version of 
Windows, plus the Novell Client 


+ Windows Server 2003, Windows Server 2003 R2, 
Windows Server 2008, or Windows Server 2008 
R2, plus the latest Service Pack, plus the Novell 
Client 


+ Novell Open Enterprise Server (OES) 2 (Linux 
version), plus the latest Support Pack 


¢ SUSE Linux Enterprise Server (SLES) 10 or 
SLES 11, plus the latest Support Pack 


The X Window System is required by the GUI 
GroupWise Installation program that steps you 
through the process of creating a new GroupWise 
system. A text-based Installation program is also 
available for installing individual components. 


BASIC GROUPWISE SYSTEM INSTALLATION 


On a machine that meets the Installation program system 
requirements: 


1 Start the GroupWise Installation program by inserting 
the GroupWise 8 DVD into the DVD drive. 
or 


Start the GroupWise Installation program in the 
downloaded GroupWise 8 image: 


Windows: \netware_windows\setup.exe 


Linux /linux/install 


2 On Windows, click Install GroupWise System. 
or 


On Linux, click Create or Update a GroupWise 
System. 


3 Follow the on-screen instructions of the Installation 
program to: 


¢ Install the GroupWise Administrator snap-ins to 
ConsoleOne 


¢ Set up your GroupWise software distribution 
directory 


¢ Create your first domain and post office 


¢ Install the Message Transfer Agent (MTA) and the 
Post Office Agent (POA) for the new domain and 
post office 


On NetWare and Windows, the Installation program 
can immediately start the agents for you. 


In addition to the GroupWise Installation Guide, see 
“Domains,” “Post Offices,” “Message Transfer Agent,” and 
“Post Office Agent” in the GroupWise Administration Guide 
for more information. 


Accessing Your GroupWise Mailbox 


Each GroupWise user has a mailbox in a post office. Ina 
corporate workplace environment, users with Windows 
workstations can run the GroupWise Windows client to 
access their mailboxes and to send and receive mail. Users 
with Linux workstations can run the GroupWise Linux client. 
Users with Macintosh workstations can run the GroupWise 
Mac client. 


GROUPWISE WINDOWS CLIENT WORKSTATION 
REQUIREMENTS 


O x86-32 processor or x86-64 processor 
On a 64-bit processor, GroupWise still runs as a 32-bit 
application. 


O Any of the following Windows versions, plus the latest 
Service Pack: 


+ Windows XP on a 300 MHz or higher workstation 
with at least 128 MB of RAM 


+ Windows Vista on a 1 GHz or higher workstation 
with at least 1 GB of RAM 


+ Windows 7 on a 1 GHz or higher workstation with 
at least 1 GB of RAM 


1) 200 MB of free disk space to install the Windows client 


GROUPWISE WINDOWS CLIENT INSTALLATION 


At a Windows workstation that meets the client 
requirements: 
1 Insert the GroupWise 8 DVD. 
or 


Start the GroupWise Installation program in the 
downloaded GroupWise 8 image by running 
\nw_win\setup.exe. 


2 Click Install More Components > Install GroupWise 
Client to start the client Setup program. 


3 Follow the on-screen instructions to install the 
Windows client software on your workstation. 


The client Setup program can immediately start the 
GroupWise Windows client for you. In addition, the 
installation process adds a GroupWise Windows client 
icon to your desktop. 


4 Double-click the GroupWise Windows client icon to 
start the Windows client 


For system-wide rollout of the Windows client software, you 
will probably not provide a DVD or downloaded image to 
each GroupWise user. See “Client” in the GroupWise 
Administration Guide for various client rollout alternatives, 
including the use of Novell ZENworks. 


GROUPWISE LINUX CLIENT WORKSTATION 
REQUIREMENTS 


O x86-32 processor or x86-64 processor 
On a 64-bit processor, GroupWise still runs as a 32-bit 
application. 


O SUSE Linux Enterprise Desktop (SLED) 10 or SLED 
11, plus the KDE desktop or the GNOME desktop 


@ 200 MB of free disk space to install the Linux client 


GROUPWISE LINUX CLIENT INSTALLATION 


At a Linux workstation that meets the Linux client 
requirements: 


1 Insert the GroupWise 8 DVD, then click Yes if you are 
prompted to allow auto-run. 
or 


Start the GroupWise Installation program in the 
downloaded GroupWise 8 image by running /linux/ 
install. 


2 Specify the root password, then click OK. 
3 Select the language you want, then click OK. 


4 Click Install Products > Install GroupWise Client. 


The GroupWise Linux client is installed to /opt / 
novell/groupwise/client. The installation process 
adds a GroupWise Linux client icon to your desktop. 


5 Double-click the GroupWise Linux client icon to start 
the Linux client. 


For system-wide rollout of the Linux client software, you will 
probably not provide a DVD or downloaded image to each 
GroupWise user. See “Client” in the GroupWise 
Administration Guide for various client rollout alternatives, 
including the use of Novell ZENworks. 


GROUPWISE MAC CLIENT WORKSTATION 
REQUIREMENTS 


O x86-32 processor or x86-64 processor 


On a 64-bit processor, GroupWise still runs as a 32-bit 
application. 


O Mac OS 10.4 (Tiger), Mac OS 10.5 (Leopard), Mac OS 
X for Intel, or Mac OS X for PowerPC, plus the latest 
update 


© Apple Java Virtual Machine (JVM) 1.5 or later 
O 75 MB of free disk space to install the Mac client 


GROUPWISE MAC CLIENT INSTALLATION 


At a Macintosh workstation that meets the Mac client 
requirements: 


1 Insert the GroupWise 8 DVD, double-click the CDROM 
icon that appears on your desktop, double-click the 
mac folder, then double-click the GroupWise . dmg file 
to create the GroupWise package. 


or 


Double-click the downloaded GroupWise .dmg file to 
create the GroupWise package. 


2 Drag the GroupWise package to the Applications 
folder to install the software on your Mac. 


3 Drag the GroupWise package from the Applications 
folder to the Mac dock to create a GroupWise icon 
there for convenient access. 


4 Click the GroupWise Mac client icon on the dock to 
start the Mac client. 


Connecting Your GroupWise System to the 
Internet 


The GroupWise Internet Agent adds Internet messaging 
services to your GroupWise system. With the Internet 
Agent installed, GroupWise users can send messages to 
recipients anywhere on the Internet. They can connect to 
their GroupWise mailboxes by using standard POP3, 
IMAP4, or SOAP e-mail clients instead of a GroupWise 
client. GroupWise users can also subscribe to Internet list 
servers and RSS feeds in the GroupWise Windows client. 


GROUPWISE INTERNET AGENT SYSTEM REQUIREMENTS 


O Any server operating system listed in “GroupWise 
System Requirements” on page 1 


O Internet connectivity, including an Internet Service 
Provider (ISP) or in-house DNS address resolution 


GROUPWISE INTERNET AGENT INSTALLATION 


1 Start the GroupWise Installation program, as described 
in “Basic GroupWise System Installation” on page 2. 


2 On Windows, click Install GroupWise System, click 
Next to accept a Standard installation, select /nstall 
Individual Components, select only GroupWise 
Internet Agent, then click Next. 


or 


On Linux, click Install Products > Install GroupWise 
Internet Agent. 


3 Follow the on-screen instructions to install the Internet 
Agent to a NetWare, Linux, or Windows server. 


On NetWare or Windows, the Installation program can 
immediately start the Internet Agent for you. 


In addition to the GroupWise Installation Guide, see 
“Internet Agent” in the GroupWise Administration Guide for 
more information. 


Accessing Your GroupWise Mailbox from 
Your Web Browser or Mobile Device 


GroupWise WebAccess enables GroupWise users to 
access their GroupWise mailboxes through Web browsers 
and mobile devices. The WebAccess Agent communicates 
with other GroupWise agents to obtain information from 
GroupWise mailboxes. The WebAccess Application 
integrates into your Web server so that GroupWise mailbox 
information can be displayed in your Web browser or on 
your mobile device. 


GROUPWISE WEBACCESS SYSTEM REQUIREMENTS 


O Any server operating system listed in “GroupWise 
System Requirements” on page 1 


O A supported Web server: 


+ NetWare 6.5: Apache 2.0 plus Tomcat 4.1 plus 
the Jakarta Connector 


+ Linux: Apache 2.2 plus Tomcat 5.0 plus the 
ModProxy module 


+ Windows Server 2003/2003 R2: Microsoft Internet 
Information Server (IIS) 6 or later plus Tomcat 5.5 
plus the Jakarta Connector 1.2 or later 


+ Windows Server 2008/2008 R2: Microsoft Internet 
Information Server (IIS) 7 or later plus Tomcat 5.5 
plus the Jakarta Connector 1.2 or later 


O Any of the following Web browsers: 
¢ Linux: Mozilla Firefox 


¢ Windows: Microsoft Internet Explorer 6.0 or later; 
Mozilla Firefox 


¢ Macintosh: The latest version of Safari for your 
Mac OS; Mozilla Firefox 


©) Any mobile device that supports Wireless Access 
Protocol (WAP) and has a microbrowser that supports 
Hypertext Markup Language (HTML) 4.0 or later, or 
Wireless Markup Language (WML) 1.1 or later 


GROUPWISE WEBACCESS INSTALLATION 


1 Start the GroupWise Installation program, as described 
in “Basic GroupWise System Installation” on page 2. 


2 On Windows, click Install GroupWise System, click 
Next to accept a Standard installation, select /nstall 
More Components, then click Install WebAccess. 


or 


On Linux, click Install Products > Install GroupWise 
WebAccess. 


3 Follow the on-screen instructions to install the 
WebAccess Agent to a NetWare, Linux, or Windows 
server and to install the WebAccess Application to the 
Web server of your choice. 


On NetWare and Windows, the Installation program 
can immediately start the WebAccess Agent and Web 
server for you. 


4 To display the WebAccess client login page in your 
Web browser or mobile device, use the following URL: 


http://web_server_address/gw/webacc 


Replace web_server_address with the IP address or 
DNS hostname of your Web server. 


In addition to the GroupWise Installation Guide, see 
“WebAccess” in the GroupWise Administration Guide for 
more information. 


Publishing Your Calendar and Free/Busy 
Information on the Web 


The GroupWise Calendar Publishing Host enables 
GroupWise users to publish their personal GroupWise 
Calendars and free/busy status publicly on the Internet so 
that non-GroupWise users can see their schedules and 
availability. This helps non-GroupWise users schedule 
convenient appointments with GroupWise users. 


In addition to the GroupWise Installation Guide, see 
“Calendar Publishing Host” in the GroupWise 
Administration Guide for more information. 


Synchronizing Your Mobile Device with 
GroupWise 


You can use Novell Data Synchronizer to synchronize e- 

mail and other Personal Information Manager (PIM) data 

from GroupWise to mobile devices that support Microsoft 
ActiveSync protocol 2.5 or later. Supported mobile device 
operating systems include: 


+ Android 2.0 

+ Apple OS 2.0, 3.0, 3.1, or later 
+ Maemo 5.0 Internet Tablet OS 
+ Palm OS and Palm Web OS 


¢ Symbian Series 60 3rd Edition, 4th Edition, or 5th 
Edition 


+ Windows Mobile 6.0, 6.1, and 6.5 


For installation instructions, see the Novell Data 
Synchronizer Mobility Pack Installation Guide on the Novell 
Data Synchronizer Documentation Web site (http:// 
www.novell.com/documentation/datasynchronizer1). 


You can synchronize GroupWise with your BlackBerry 
device by using BlackBerry Enterprise Server for 
GroupWise (http://na.blackberry.com/eng/services/ 
business/server/full/). 


Communicating in Real Time with Other 
GroupWise Users 


Novell Messenger is a cross-platform, corporate-based, 
secure instant messaging solution that supports instant 
messaging, presence, chat rooms, broadcasts, and 
archiving of conversations for GroupWise users. 
Messenger runs on NetWare, Linux, and Windows. 


For basic instructions, see the Messenger Quick Start on 
the Novell Messenger Documentation Web site (http:// 
www.novell.com/documentation/novell_messenger21). For 
more detailed information, see the Novell Messenger 
Installation Guide and the Novell Messenger Administration 
Guide. 


Collaborating with Other GroupWise Users 


Novell Teaming enhances GroupWise by providing easy 
document management and sharing, team calendars and 
task lists, workflows, discussion threads, wikis, blogs, RSS 
feeds, and more. 


For installation and usage instructions, see the Novell 
Teaming Documentation Web site (http://www.novell.com/ 
documentation/teaming21). 


Novell Conferencing enhances GroupWise by providing 
instant voice conferencing, phone number management, 
meeting scheduling and management, chat, desktop 
sharing, whiteboarding, and more. 


For installation and usage instructions, see the Novell 
Conferencing Documentation Web site (http:// 
www.novell.com/documentation/novell_ conferencing). 


Monitoring Your GroupWise System 


GroupWise Monitor is a monitoring and management tool 
that allows you and other GroupWise administrators to 
monitor GroupWise and Messenger agents and GroupWise 
gateways from any location where you are connected to the 
Internet and have access to a Web browser. Some agent 
administration can also be performed from your Web 
browser. 


GROUPWISE MONITOR SYSTEM REQUIREMENTS 


O Any server operating system listed in “GroupWise 
System Requirements” on page 1 


However, the Monitor Agent is not available on 
NetWare. 


O Any Web server listed in “GroupWise WebAccess 
System Requirements” on page 4 


O Any Web browser listed in “GroupWise WebAccess 
System Requirements” on page 4 


More detailed Monitor requirements are listed in the 
GroupWise Installation Guide. 


GROUPWISE MONITOR INSTALLATION 


1 Start the GroupWise Installation program, as described 
in “Basic GroupWise System Installation” on page 2. 


2 On Windows, click Install GroupWise System, click 
Next to accept a Standard installation, select /nstall 
More Components, then click Install Monitor. 


or 


On Linux, click Install Products > Install GroupWise 
Monitor. 


3 Follow the on-screen instructions to install the Monitor 
Agent to a Linux or Windows server and to install the 
Monitor Application to the Web server of your choice. 


On Windows, the Installation program can immediately 
start the Monitor Agent and Web server for you. 


4 To display the Monitor Web console in your Web 
browser, use the following URL: 


http://web_server_address/gwmon/gwmonitor 


Replace web_server_address with the IP address or 
DNS hostname of your Web server. 


The Monitor Web console, which interacts with your 
Web server, enables you to monitor agents from 
outside your firewall at the following URL: 


http://web_server_address/gwmon/gwmonitor 


5 To display the more full-featured Monitor Agent Web 
console in your Web browser, use the following URL: 


http://web_server_address: 8200 


The Monitor Agent Web console, provided by the 
Monitor Agent itself, can be accessed only from behind 
your firewall. 


In addition to the GroupWise Installation Guide, see 
“Monitor” in the GroupWise Administration Guide for more 
information. 


Clustering Your GroupWise System 


Clustering ensures high availability and manageability of 
critical network resources by providing failover, failback, 
and migration (load balancing) capabilities for clustered 
resources. By setting up post offices in a cluster, you 
ensure that GroupWise users can always access their 
mailboxes. By setting up the WebAccess Agent in a cluster, 
you ensure that GroupWise users can always access their 
mailboxes from Web browsers and mobile devices. By 
setting up the Internet Agent in a cluster, you ensure that 


GroupWise users can always send mail across the Internet. 


GroupWise can be installed in clusters on NetWare, Linux, 
and Windows. For more information, see the GroupWise 
Interoperability Guide. 


Connecting Your GroupWise System to Other 
E-Mail Systems 


You can connect your GroupWise system to other e-mail 
systems, including Microsoft Exchange and Lotus Notes. 
You can also migrate Exchange users into your GroupWise 
system. 


For more information, see the GroupWise Gateways 
Documentation Web site (http://www.novell.com/ 
documentation/gwgateways) and the GroupWise Utilities 
Documentation Web site (http://www.novell.com/ 
documentation/gwutilities). 


Updating Your GroupWise System with 
Support Packs 


Updates to your GroupWise software are provided on the 
Novell Downloads page (http://download.novell.com). 


1 Follow the installation instructions in the Readme for 
each GroupWise Support Pack, keeping in mind the 
following important guidelines: 


+ Always update your primary domain first. 


+ When updating any domain, always start the MTA 
first (before any POAs) so that the domain 
database is fully updated. 


¢ Only after updating a domain and starting the 
MTA for it should you start the updated POAs for 
the post offices that belong to the updated 
domain. 


For more information, see “Update” in the GroupWise 
Installation Guide. 
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